@brief stored a new scanned channel into a dvb_file struct
@ingroup file
@param dvb_file file struct to be filled
@param parms struct dvb_v5_fe_parms used by libdvbv5 frontend
@param dvb_desc struct dvb_desc as described at descriptors.h, filled
with the descriptors associated with a DVB channel.
those descriptors can be filled by calling one of the
scan functions defined at dvb-sat.h.
@param get_detected if different than zero, uses the frontend parameters
obtained from the device driver (such as modulation,
FEC, etc)
@param get_nit if true, uses the parameters obtained from the MPEG-TS
NIT table to add newly detected transponders.
This function should be used to store the services found on a scanned
transponder. Initially, it copies the same parameters used to set the
frontend, that came from a file where the Service ID and Elementary Stream
PIDs are unknown. At tuning time, it is common to set the device to tune
on auto-detection mode (e. g. using QAM/AUTO, for example, to autodetect
the QAM modulation). The libdvbv5's logic will be to check the detected
values. So, the modulation might, for example, have changed to QAM/256.
In such case, if get_detected is 0, it will store QAM/AUTO at the struct.
If get_detected is different than zero, it will store QAM/256.
If get_nit is different than zero, and if the MPEG-TS has info about other
physical channels/transponders, this function will add newer entries to
dvb_file, for it to seek for new transponders. This is very useful especially
for DVB-C, where all transponders belong to the same operator. Knowing one
frequency is generally enough to get all DVB-C transponders.
@brief stored a new scanned channel into a dvb_file struct @ingroup file
@param dvb_file file struct to be filled @param parms struct dvb_v5_fe_parms used by libdvbv5 frontend @param dvb_desc struct dvb_desc as described at descriptors.h, filled with the descriptors associated with a DVB channel. those descriptors can be filled by calling one of the scan functions defined at dvb-sat.h. @param get_detected if different than zero, uses the frontend parameters obtained from the device driver (such as modulation, FEC, etc) @param get_nit if true, uses the parameters obtained from the MPEG-TS NIT table to add newly detected transponders.
This function should be used to store the services found on a scanned transponder. Initially, it copies the same parameters used to set the frontend, that came from a file where the Service ID and Elementary Stream PIDs are unknown. At tuning time, it is common to set the device to tune on auto-detection mode (e. g. using QAM/AUTO, for example, to autodetect the QAM modulation). The libdvbv5's logic will be to check the detected values. So, the modulation might, for example, have changed to QAM/256. In such case, if get_detected is 0, it will store QAM/AUTO at the struct. If get_detected is different than zero, it will store QAM/256. If get_nit is different than zero, and if the MPEG-TS has info about other physical channels/transponders, this function will add newer entries to dvb_file, for it to seek for new transponders. This is very useful especially for DVB-C, where all transponders belong to the same operator. Knowing one frequency is generally enough to get all DVB-C transponders.
@return Returns 0 if success, or, -1 if error.